.. _cmcDioGetIomodeMulti:

cmcDioGetIomodeMulti 
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmcDioGetIomodeMulti([in] VT_I4 BoardID, [in] VT_I4 Axis, [in] VT_I4 IniChan, 
    [in] VT_I4 NumChan, [out] VT_PI4 InOutModeMask )                     

DESCRIPTION
`````````````  

- cmcDioSetIomodeMulti()/cmcDioGetIomodeMulti() 함수는 다중(Multi) 디지털 입출력 채널의 용도(Mode)를 
  설정 혹은 설정 상태를 반환합니다.   

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cmc 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ Axis: Axis 번호(Axis는 3번부터 시작합니다.) 
 
▶ IniChan : 시작 채널 번호. 통합 채널로 관리되는 채널 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 
최대 통합 채널수 - 1 이하의 값을 채널 번호로 설정할 수 있습니다. 
 
▶ NumChan : 시작 채널로부터 몇 개의 채널의 상태를 확인할 것인지에 대한 값을 전달합니다. (최대 
32개 채널까지 설정 가능합니다.) 
 
▶ InOutModeMask : 이 매개변수를 통하여 다중(Multi) 디지털 I/O 채널의 용도(Mode) 설정 및 설정상태를 
반환합니다. (32비트, BIT0 ~ BIT31) 

.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0 (cmcFALSE), Input Mode 
    1 (cmcTRUE), Output Mode


RETURN VALUE
`````````````
.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    음수, 수행 실패
    0(ERR_NONE), 수행 성공


REFERENCE
`````````````

- 본 함수는 ceD16CM 모듈 전용 함수입니다. 

EXAMPLE
```````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink3_SDK.h” 
    #include “ComiMLink3_SDK_Def.h” 
    /* ceD16CM 모듈의 0~3번 채널을 디지털 출력 모드로 설정하고 설정된 상태를 확인합니다. */ 
    #define INI_CH  0 
    #define NUM_CH 4 
    Long BoardID = 0; 
    long lGetDioModeMulti = 0; 
    // 0~3 번 채널을 디지털 출력 모드로 설정합니다. 
    if(cmcDioSetIomodeMulti (BoardID, 3,  INI_CH, CH_NUM, 0xF ) != ERR_NONE ) 
    { 
    OutputDebugString ( " cmcDioSetIomodeMulti function Fail" ); 
    } 
    // 0~3 번 채널의 입출력 모드 설정 상태를 확인합니다. 
    if(cmcDioGetIomodeMulti (BoardID, 3, INI_CH, CH_NUM, &lGetDioModeMulti ) != ERR_NONE ) 
    { 
    OutputDebugString ( " cmcDioGetIomodeMulti function Fail" ); 
    }